package com.ruoyi.exam.mapper;

import java.util.List;

import com.ruoyi.exam.domain.entity.Question;
import org.apache.ibatis.annotations.Param;

/**
 * 题目，存储题目信息Mapper接口
 * 
 * @author ruoyi
 * @date 2024-12-17
 */
public interface QuestionMapper {
    /**
     * 查询题目，存储题目信息
     * 
     * @param id 题目，存储题目信息主键
     * @return 题目，存储题目信息
     */
    public Question selectQuestionById(Long id);

    /**
     * 查询题目，存储题目信息列表
     * 
     * @param question 题目，存储题目信息
     * @return 题目，存储题目信息集合
     */
    public List<Question> selectQuestionList(Question question);

    /**
     * 新增题目，存储题目信息
     * 
     * @param question 题目，存储题目信息
     * @return 结果
     */
    public int insertQuestion(Question question);

    /**
     * 修改题目，存储题目信息
     * 
     * @param question 题目，存储题目信息
     * @return 结果
     */
    public int updateQuestion(Question question);

    /**
     * 删除题目，存储题目信息
     * 
     * @param id 题目，存储题目信息主键
     * @return 结果
     */
    public int deleteQuestionById(Long id);

    /**
     * 批量删除题目，存储题目信息
     * 
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteQuestionByIds(Long[] ids);

    /**
     * 随机抽取题目
     * 
     * @param question 题目查询条件
     * @param count    需要的题目数量
     * @param outlines 题库名称列表
     * @return 题目列表
     */
    public List<Question> selectRandomQuestions(
            @Param("question") Question question,
            @Param("count") Integer count,
            @Param("outlines") List<String> outlines);

    /**
     * 根据题库名称列表查询题目
     *
     * @param outlines 题库名称列表
     * @return 题目列表
     */
    public List<Question> selectQuestionsByOutlines(@Param("outlines") List<String> outlines);
}
